home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / edu / stereogr.zip / PMAKER.DOC < prev    next >
Text File  |  1994-11-18  |  18KB  |  618 lines
  1.  
  2.                                 PMAKER 1.0
  3.                                 ==========
  4.  
  5.                           a Pattern Maker for SIS
  6.                          (Single Image Stereogram)
  7.  
  8.                    Copyright (C) Carlo Moretti (Jul) 1994
  9.  
  10.                       email: moretti@cobra.csr.unibo.it
  11.                          or: moretti@zeus.csr.unibo.it
  12.  
  13.  
  14.                                 PMAKER.DOC
  15.                                 ==========
  16.  
  17.  
  18.  
  19.         INDEX
  20.         =====
  21.  
  22.         0       INTRODUCTION
  23.  
  24.         1       HOW TO USE
  25.             1.0     HOW TO USE PMAKER -intro-
  26.             1.1     BASIC SYNTAX
  27.             1.2     GENERAL OPTIONS
  28.             1.3     HOW TO GET HELP
  29.  
  30.         2       BASIC CONCEPTS - SPECIFIC OPTIONS
  31.             2.0     BASIC CONCEPTS -intro-
  32.             2.1     FEATURES
  33.             2.2     SIMPLE HELP FOR EACH FEATURE
  34.                 2.2.0   STAIN
  35.                 2.2.1   BLUR
  36.                 2.2.2   LINE
  37.                 2.2.3   WAVE
  38.                 2.2.4   TUBE
  39.                 2.2.5   RIPPLE
  40.                 2.2.6   CIRCLE
  41.                 2.2.7   SPOT
  42.                 2.2.8   SPHERE
  43.                 2.2.9   BUBBLE
  44.                 2.2.10  SQUARE
  45.                 2.2.11  MINE
  46.                 2.2.12  LAKE
  47.                 2.2.13  STAR
  48.                 2.2.14  SKY
  49.  
  50.         3       GREETINGS
  51.             3.0     PLEASE TAKE PART IN!!
  52.             3.1     THE FUTURE...
  53.             3.2     PLEASE, REGISTER!
  54.             3.3     GREETINGS
  55.  
  56.  
  57.                                                       - INTRODUCTION -   - 0 -
  58.  
  59.  
  60.         INTRODUCTION
  61.         ============
  62.  
  63.  
  64.          This program is the first working version of a sofware developed to
  65.         obtain better result for SIS (Single Image Stereogram) by generating
  66.         pattern files to 'cover' the holusions.
  67.  
  68.          I was tired to always see the same RDSs (Random Dots Stereograms)
  69.         made of simple random pixels, so I wanted to innovate stereograms
  70.         by writing this program... I hope someone likes this!
  71.  
  72.          The output of this program is a simple .TGA file (truecolor 24 bit,
  73.         compressed or uncompressed) which contains the pattern to use with
  74.         the SIS generator; obviously you need a SIS generator (like CRUMBLER)
  75.         to see the final result on your stereograms.
  76.  
  77.          PMAKER 1.0 is able to generate 15 different kind of image patterns,
  78.         by implementing geometrical, fractal and trigonometrical functions and
  79.         uses a random color generation to obtain always different results.
  80.  
  81.          For each feature you have a lot of options to improve your works,
  82.         see next chapters about.
  83.  
  84.  
  85.  
  86.                                                         - HOW TO USE -   - 1 -
  87.  
  88.  
  89. 1.0     HOW TO USE PMAKER -intro-
  90.         =========================
  91.  
  92.  
  93.          PMAKER is totally batch oriented. Every option that you require
  94.         to use must be inserted into the dos prompt command line.
  95.          I'm not too sure if alot of people like this layout (may forget an
  96.         option, must remember the right syntax, etc.), anyway I choose this
  97.         layout because you can run PMAKER inside a batch file and that I can
  98.         also avoid writing tedious user interface that could not be nice but
  99.         needs alot of time.
  100.  
  101.          Anyway, the next version of CRUMBLER will include PMAKER with a GUI.
  102.  
  103.          The syntax is not too hard to remember, I tried to associate a
  104.         menmonical name for each option.
  105.  
  106.  
  107. 1.1     BASIC SYNTAX
  108.         ============
  109.  
  110.  
  111.          First, say PMAKER doesn't require an input file.
  112.          Type at your prompt dos:
  113.  
  114.                 > PMAKER <filename[.TGA]> <basePattern> [+<options>]
  115.  
  116.          - <filename> is the output .TGA file (".TGA" can be omitted)
  117.  
  118.          - <basePattern> is one of the 15 following features:
  119.            stain, blur, line, wave, tube, ripple, circle, spot, sphere,
  120.            bubble,square, mine, lake, star, sky
  121.            (see 2.x about features)
  122.  
  123.          - <options> are *A LOT*! There are:
  124.  
  125.            - general options (these are valid for each feature)
  126.            - specific options (for each feature there are specific options
  127.              which design the characteristics of the pattern)
  128.  
  129.            All the supported options are omittable and for each option
  130.            there's a Default value to make PMAKER easier.
  131.  
  132.            To see help about specific options see 2.2.x
  133.  
  134.  
  135.  
  136.                                                         - HOW TO USE -   - 1 -
  137.  
  138.  
  139. 1.2     GENERAL OPTIONS
  140.         ===============
  141.  
  142.  
  143.          General options tell PMAKER which range of colors to use and give
  144.         the information about the output file:
  145.  
  146.         +xXXX   horizontal resoulution (each value is right, limit is your
  147.                 conventional memory)
  148.  
  149.         +yXXX   vertical resolution (no limits)
  150.  
  151.         +o      tells PMAKER to overwrite an existing file;
  152.                 if omitted PMAKER stops if encounters an existing file.
  153.  
  154.         +rle    lets PMAKER create a compressed Run LEngth .TGA file;
  155.                 if omitted the output is uncompressed.
  156.  
  157.         +scRRR,GGG,BBB  -and-
  158.         +ecRRR,GGG,BBB  tell PMAKER the starting and ending colors for random
  159.                         color generation: PMAKER uses red values between
  160.                         scRRR and ecRRR, green between scGGG and ecGGG, etc.
  161.  
  162.         +tcRRR,GGG,BBB  is the Top background color
  163.         +bcRRR,GGG,BBB  is the Bottom background color
  164.                         These are used only when choosen feature requires them.
  165.  
  166.         Each RRR, GGG, BBB are 0..255 value, so this is an example:
  167.  
  168.                 > PMAKER out.tga sky +sc0,0,0 +ec255,255,255
  169.  
  170.         (+[s|e|t|b]cRRR,GGG,BBB options needs NO spaces between r,g,b colors!!)
  171.  
  172.  
  173.  
  174. 1.3     HOW TO GET HELP
  175.         ===============
  176.  
  177.  
  178.          If you want to see PMAKER's basic help type:
  179.  
  180.                 > PMAKER ?
  181.  
  182.         (this will show the general options above) and type:
  183.  
  184.                 > PMAKER ? <basePattern>
  185.  
  186.         to obtain help on specific options about <basePattern>.
  187.  
  188.  
  189.                                                     - BASIC CONCEPTS -   - 2 -
  190.  
  191.  
  192. 2.0     BASIC CONCEPTS -intro-
  193.         ======================
  194.  
  195.  
  196.          PMAKER is made of simple routines which make use of pseudo-fractals
  197.         random color distribution, or mathematical simulation of interference
  198.         between different 2D waves or random colored shapes generation.
  199.          These routines have been simple to implement and lot of the
  200.         patterns results are 'cylindrical', such as the right-hand side can
  201.         be placed next to the left-hand side without appearing discontinuous.
  202.         This is useful for SIS, in which the patterns are always placed next
  203.         to each other.
  204.  
  205.          Unfortunately this feature causes a little loose in execution time.
  206.  
  207.          The base patterns are made of simple shapes like circles (empty,
  208.         filled or blur), lines, 'waved lines', stars and squares or
  209.         random color distributions (similar to plasma) or pseudo-fractal
  210.         actractors which causes odd color patterns.
  211.  
  212.  
  213.  
  214. 2.1     FEATURES
  215.         ========
  216.  
  217.  
  218.          There are 15 available features (as shown), but few are very similar
  219.         in facts they differ only on the filling method.
  220.  
  221.          These are the base patterns available:
  222.  
  223.         - stain  (pseudo-fractal actractors, COOL!)
  224.         - blur   (similar to plasma, VERY NICE!)
  225.         - line   (disorded and different thickness lines)
  226.         - wave   (disorded monodimensional blur waves, THE BEST!!)
  227.         - tube   (similar to wave but with a 'depth' appearance)
  228.         - ripple (a single random-colored linear ripple)
  229.         - circle (empty circles)
  230.         - spot   (filled circles)
  231.         - sphere (depth effect circles)
  232.         - bubble (blur circles)
  233.         - square (regular flat subdivision in squares)
  234.         - mine   (similar to 'mine-sweeper' background)
  235.         - lake   (interference between 2D waves, NOT NICE FOR SIS BUT GREAT!)
  236.         - star   (four tips stars)
  237.         - sky    (random dots)
  238.  
  239.  
  240.  
  241.                                                   - SPECIFIC OPTIONS -   - 2 -
  242.  
  243.  
  244. 2.2     SIMPLE HELP FOR EACH FEATURE
  245.         ============================
  246.  
  247.  
  248.          The following helps are a simple description about the options you
  249.         can use for each base pattern. Often the same options are valid for
  250.         more than one base pattern, maybe only a slight difference
  251.         in their meanings. So check the help that is avaible or use the
  252.         PMAKER ? <pattern>
  253.         command line to see the help commands.
  254.  
  255.  
  256.  
  257. 2.2.0   STAIN
  258.         =====
  259.  
  260.  
  261.          This is the pseudo-fractal random actractor pattern generator.
  262.          Specific options are:
  263.  
  264.         +nXXX   number of random placed actractors
  265.  
  266.         +lXXX   onion level. The rgb color values are multiplied for +l option
  267.                 and divided for 256; the remainder is used as color.
  268.                 It gives a nice 'onion' appearance to the image.
  269.                 Good values are 5..20
  270.  
  271.         +rMIN,MAX  tells the random number generator the range of the possible
  272.                    values of the actractive ray for each actractor.
  273.                    Good values are 80-120; Max should be < +x option.
  274.  
  275.          This topic doesn't care about the background colors (see 1.2)
  276.  
  277.  
  278.  
  279. 2.2.1   BLUR
  280.         ====
  281.  
  282.  
  283.          This is similar to 'plasma' fractal, but it's calculated in a easier
  284.         way: for each <+d> pixels the function calculates a random color, then
  285.         it fills empty pixels by averaging the closed calculated pixels.
  286.          Specific options are:
  287.  
  288.         +dXXX   distance between a random color and the next one
  289.                 Good values are between 1 (totally random dot) and 10.
  290.                 Higher values can make SIS loose details.
  291.  
  292.          This topic doesn't care about background colors (1.2)
  293.  
  294.  
  295.  
  296.                                                   - SPECIFIC OPTIONS -   - 2 -
  297.  
  298.  
  299. 2.2.2   LINE
  300.         ====
  301.  
  302.  
  303.          Creates disorded lines with different thickness.
  304.  
  305.         +nXXX   number of lines to be draw
  306.  
  307.         +wMIN,MAX  thickness range value
  308.  
  309.          This topic uses every generic options.
  310.  
  311.  
  312.  
  313. 2.2.3   WAVE
  314.         ====
  315.  
  316.  
  317.          Similar to line topic, draws monodimensional disorded waves.
  318.  
  319.         +nXXX   number of waves
  320.  
  321.         +wMIN,MAX  range for thickness values
  322.  
  323.         +fMIN,MAX  range for frequency values, floating point
  324.  
  325.         +aMIN,MAX  range for amplitude values
  326.  
  327.         +pMIN,MAX  range for phase values, floating point
  328.  
  329.          Uses every generic options.
  330.  
  331.  
  332.  
  333. 2.2.4   TUBE
  334.         ====
  335.  
  336.  
  337.          This topic is VERY similar to the previous, but the wave borders
  338.         fade to background color.
  339.  
  340.         +nXXX   number of tubes
  341.  
  342.         +wMIN,MAX  range for thickness values
  343.  
  344.         +fMIN,MAX  range for frequency values, floating point
  345.  
  346.         +aMIN,MAX  range for amplitude values
  347.  
  348.         +pMIN,MAX  range for phase values, floating point
  349.  
  350.          Uses every generic options.
  351.  
  352.  
  353.  
  354.                                                   - SPECIFIC OPTIONS -   - 2 -
  355.  
  356.  
  357. 2.2.5   RIPPLE
  358.         ======
  359.  
  360.  
  361.          It's a simple linear wave randomly colored.
  362.  
  363.         +wMIN,MAX  range for distance values between one random color and next
  364.  
  365.         +fMIN,MAX  range for frequency values, floating point
  366.  
  367.         +aMIN,MAX  range for amplitude values
  368.  
  369.         +pMIN,MAX  range for phase values, floating point
  370.  
  371.          Doesn't care about background colors (1.2).
  372.  
  373.  
  374.  
  375. 2.2.6   CIRCLE
  376.         ======
  377.  
  378.  
  379.          Draws empty circles
  380.  
  381.         +nXXX   number of circles
  382.  
  383.         +rMIN,MAX  range of rays values
  384.  
  385.          Uses every generic options.
  386.  
  387.  
  388.  
  389. 2.2.7   SPOT
  390.         ====
  391.  
  392.  
  393.          Very similar to 'circle' topic: these are filled!
  394.  
  395.         +nXXX   number of spots
  396.  
  397.         +rMIN,MAX  range of rays values
  398.  
  399.          Uses every generic options.
  400.  
  401.  
  402.                                                   - SPECIFIC OPTIONS -   - 2 -
  403.  
  404.  
  405. 2.2.8   SPHERE
  406.         ======
  407.  
  408.  
  409.          Similar to previous topic, fade the spots to background giving a
  410.         spherical appearance.
  411.  
  412.         +nXXX   number of spheres
  413.  
  414.         +rMIN,MAX  range of rays values
  415.  
  416.          Uses every generic options.
  417.  
  418.  
  419.  
  420. 2.2.9   BUBBLE
  421.         ======
  422.  
  423.  
  424.          Similar to previous topic, fade the spots to background after 
  425.         previous generation, giving a 'trasparency' effect.
  426.  
  427.         +nXXX   number of bubbles
  428.  
  429.         +rMIN,MAX  range of rays values
  430.  
  431.          Uses every generic options.
  432.  
  433.  
  434.  
  435. 2.2.10  SQUARE
  436.         ======
  437.  
  438.  
  439.          Fills the image with regular randomly colored square.
  440.  
  441.         +dXXX   side of the squares. It's better if +x option (1.2) is a
  442.                 multiple of 'side', otherwise the last column on the right
  443.                 is NOT made of squares. Good values are between 1 (RDS) and 5.
  444.  
  445.          Doesn't care about background colors (1.2);
  446.  
  447.  
  448.  
  449.                                                   - SPECIFIC OPTIONS -   - 2 -
  450.  
  451.  
  452. 2.2.11  MINE
  453.         ====
  454.  
  455.  
  456.          Similar to square, but embossed. 'Mine' comes from MineSweeper for
  457.         windows: the final result is similar to a multicolored keyboard.
  458.  
  459.         +dXXX   side of base square (2.2.10). Must be > 1.
  460.  
  461.         +hxxx   height (prominence) in pixels. Must be < +d and > 0.
  462.  
  463.          Good values are +d6 +h2 or a little greater.
  464.          This topics doesn't care about background colors (1.2).
  465.  
  466.  
  467.  
  468. 2.2.12  LAKE
  469.         ====
  470.  
  471.  
  472.          Lake a particular base pattern. Draws interference between
  473.         bidimensional waves. It's not good as pattern for SIS (and it's VERY
  474.         slow too), but you can use it to generate big images, don't know,
  475.         to use as windows background... It's not bad!
  476.  
  477.         +nXXX   number of waves
  478.  
  479.         +lXXX   onion level (2.0). Best value is 1, higher values changes
  480.                 colors... Experiment!
  481.  
  482.         +rMIN,MAX  range for ray of influence values (experiment!)
  483.  
  484.         +fMIN,MAX  range for frequency values, floating point.
  485.                    Good values: 0.5 - 10.0
  486.  
  487.          Doesn't care about background colors.
  488.  
  489.  
  490.  
  491. 2.2.13  STAR
  492.         ====
  493.  
  494.  
  495.          Fill the background with stars. The stars tips fade to background.
  496.          Best results for black background and bright stars.
  497.  
  498.         +nXXX   number of stars (good values: 100..2000)
  499.  
  500.         +wMIN,MAX  range of lenghts for stars tips (good values: 5-10)
  501.  
  502.          Uses every generic options.
  503.  
  504.  
  505.  
  506.                                                   - SPECIFIC OPTIONS -   - 2 -
  507.  
  508.  
  509. 2.2.14  SKY
  510.         ===
  511.  
  512.  
  513.          Simply fills the background with random pixels.
  514.          Gives quite good results for SIS. Pretty cool!
  515.  
  516.         +nXXX   number of active pixels (don't exager... it's quite slow!)
  517.  
  518.          Obviously uses every generic options.
  519.  
  520.  
  521.  
  522.                                                          - GREETINGS -   - 3 -
  523.  
  524.  
  525. 3.0     PLEASE TAKE PART IN!!
  526.         =====================
  527.  
  528.  
  529.          As this program is SHAREWARE, you are encouraged to register it
  530.         (see below) and if you would like to suggest any new ideas,
  531.         algorithms or anything new, please don't hesitate to mail me!.
  532.          You can ALSO mail me new ideas about PMAKER also if you don't
  533.         register it!
  534.  
  535.          Please contact me for any bug you find or you think you have found!
  536.  
  537.          Please send me answers, comments, suggests, [dis]approvals, insults,
  538.         threats, or anything that turns your brain around.
  539.  
  540.          Please mail me too to send comments about:
  541.  
  542.         "batch oriented" vs. "user interface". Thanx!
  543.  
  544.  
  545.  
  546. 3.1     THE FUTURE...
  547.         ?????????????
  548.  
  549.  
  550.           I hope someone helps me to increase the power of this proggie, so we
  551.         can improve PMAKER with new algo and new topics.
  552.  
  553.          If someone is intersted i'll realize a monochrome version (not only
  554.         black and white), anyway I have no more imagination for now...
  555.  
  556.  
  557.  
  558.  
  559.                                                          - GREETINGS -   - 3 -
  560.  
  561.  
  562. 3.3     PLEASE, REGISTER!
  563.         =================
  564.  
  565.          This program is SHAREWARE like CRUMBLER and, as they are distributed
  566.         together, the registration form is only ONE!
  567.  
  568.          If you continue using this software (both CRUMBLER and PMAKER) after
  569.         a trial evaluation period of 30 days, you are encouraged to pay a
  570.         little registration fee.
  571.          Check the REGISTER.DOC to file the REGISTER.FRM form to order your
  572.         registered versions.
  573.  
  574.  
  575.  
  576. 3.2     CREDITS
  577.         =======
  578.  
  579.  
  580.          Special thanx to Duzy Patel.
  581.  
  582.          Thanx to:
  583.          Stefano Vitali, Simone Grassi and evryone else tested this prog.
  584.          Thanx to Michelle Bishop for the cat picture.
  585.  
  586.  
  587.  
  588. 3.3     GREETINGS
  589.         =========
  590.  
  591.  
  592.          I would like to send greetings all over the world, and hope this
  593.         proggie could help someone...somewhere!
  594.  
  595.  
  596.  
  597.    ::::::::::::::::::::::::::::::::::::::::::::::::::::
  598.          For whom i met via internet:
  599.          PLEASE!! mail me at
  600.  
  601.                 moretti@cobra.csr.unibo.it
  602.         or
  603.                 moretti@zeus.csr.unibo.it
  604.  
  605.         and forget old sis2g19 or einn93_5!! Thanx!
  606.    ::::::::::::::::::::::::::::::::::::::::::::::::::::
  607.  
  608.  
  609.         '' If u wanna b free, follow a cat! ,,
  610.  
  611.                             /\_/\
  612.                       ____ / o o \
  613.                     /~____   =°= /
  614.                    (______)__m_m_)
  615.  
  616.                                         -> Carlo Moretti <-
  617.  
  618.